home *** CD-ROM | disk | FTP | other *** search
/ Aminet 8 / Aminet 8 (1995)(GTI - Schatztruhe)[!][Oct 1995].iso / Aminet / mus / play / SPlayLib31.lha / superplay-lib / Docs / WAV.doc < prev   
Text File  |  1994-07-21  |  5KB  |  139 lines
  1.  
  2.   WAV.svobject
  3.  
  4.   © 1994 by Andreas R. Kleinert.
  5.  
  6.   FREEWARE. All rights reserved.
  7.  
  8.   Version      : 2.2
  9.   Release Date : 21.07.1994
  10.  
  11.  
  12.   Description
  13.   ~~~~~~~~~~~
  14.   WAV.svobject is an external Library-Module for the superplay.library V1+.
  15.  
  16.   It supports reading and writing of PC RIFF-WAVE (WAV) Sample-Files,
  17.   playing is supported as far as the Amiga is able to (8 Bit only).
  18.  
  19.  
  20.   Author
  21.   ~~~~~~
  22.   Andreas R. Kleinert
  23.   Grube Hohe Grethe 23
  24.   D-57074 Siegen
  25.   Germany
  26.  
  27.  
  28.   History :
  29.   ~~~~~~~~~
  30.   V2.2 (21.07.1994) :
  31.  
  32.    - added possibility to save all Samples from all multiple-SampleList
  33.      and to accept NULL parameters for the Source-SPObject with
  34.      SPO_Write(), so that custom applications may save their self-
  35.      created SampleLists by simply setting them via SPO_SetSampleList().
  36.      The old way behaviour is still supported (as also handling of
  37.      V1 SPObjects).
  38.    - in former versions the sourcebuffer had been left "trashed", because
  39.      conversion into the WAV format (via XOR) had not been reversed.
  40.      Now the old buffer is reconstructed after saving.
  41.  
  42.  
  43.   V2.1 (17.07.1994) :
  44.  
  45.    - integrated new "SampleList"-Functions for exporting more than one
  46.      sample
  47.  
  48.  
  49.   V1.4 (19.06.1994) :
  50.  
  51.    - version still reflected 1.2 instead 1.3. Now we're at 1.4 :-)
  52.    - changed way of reading the WAV-Header, so that files with
  53.      extended Headers (don't know if there are such files) might be
  54.      read as well in the future, while files with shortened header
  55.      (possibly corrupted) will no longer be accepted (they would be
  56.      interpreted wrong, anyway).
  57.    - made some WORDs to UWORDs
  58.    - fixed possible bug-source (memory)
  59.  
  60.  
  61.   V1.3 (29.04.1994) :
  62.  
  63.    - fixed (hopefully) "header not located" problems within memory
  64.      delocation
  65.    - also fixed AllocMem()/FreeVec() conflict with SampleData-Buffer
  66.  
  67.  
  68.   V1.2 (31.03.1994) :
  69.  
  70.    You should consider V1.1 to be a _BAD_ BETA-Version now, because :
  71.  
  72.    - as soon as I got some original (not converted) WAV-Files, I found
  73.      out, that V1.1 was more or less UN-USEABLE, because it was so
  74.      BUGGY ;<
  75.    - IntelToMotorola (and reverse) conversion was not correct for
  76.      LONGwords, which concerned :
  77.  
  78.       - ChunkSize           (File Header : FileSize)
  79.       - SubSize             (Fmt  Chunk  : Chunk Size)
  80.       - SamplesPerSec       (Fmt  Chunk  : Frequency)
  81.       - BytesPerSec         (Fmt  Chunk  : Frequency, stereo)
  82.       - DataSize            (Data Chunk  : Chunk Size)
  83.  
  84.      If you were "lucky", this might have meant, that the samples would
  85.      have been played too short and with the wrong frequency ;)
  86.      If you were "unlucky", they would not have been played at all !
  87.  
  88.      Due to these bugs, only self-written WAV-Files were replayed
  89.      correctly, because they were WRITTEN AS WRONG as they have been read.
  90.    - The Fmt-Header ID was written as "FMT " instead of "fmt ", so that
  91.      perhaps not all other programs might accept files written with the
  92.      old V1.1-WAV.spobject.
  93.      Nevertheless you may recover your self-created WAV-Files by passing
  94.      them through the Freeware-Tool SoundZAP V2.3 (Fish-Disk 646), which
  95.      accepts them obviously (only the frequency might be wrong).
  96.  
  97.    - Now the positive things :
  98.  
  99.      - with this version not only the File Header, but also the single Chunks
  100.        are now checked for their correct IDs : - "WAVE","RIFF" (Header)
  101.                                                - "fmt "        (Fmt-Chunk)
  102.                                                - "data"        (Data-Chunk)
  103.      - since this version also a length of the Fmt-Chunk greater than
  104.        16 Bytes will be handled correctly : this definitely will not happen
  105.        at the time, but may happen with future expansions of the RIFF-WAVE-
  106.        Format
  107.      - the Longword-Conversion now works ;)
  108.      - now testing with "real" WAV-Files has been done :
  109.        there's a high probability now, that all WAV-Files - assuming that
  110.        they actually fit into your Chip Memory ;) - will be played in the
  111.        right way
  112.      - now there's more information given about the loaded Sample :
  113.        This information will even be available, even if there's not enough
  114.        memory to store the actual sample-data (e.g. more than 2 MByte
  115.        sample data against 1 MByte free Chip Memory)
  116.      - and more
  117.  
  118.  
  119.   V1.1 (30.03.1994) :
  120.  
  121.    - we use RawDoFmt()-based sprintf()-routine, instead of SAS/C's.
  122.      This saves about 1800 Bytes.
  123.    - "utility.library" is not used, because this crashes the Player-Task
  124.      and no reason for this could be found.
  125.    - first version
  126.  
  127.  
  128.   Literature
  129.   ~~~~~~~~~~
  130.   [1] "c't", Magazin für Computertechnik, Issue 1/1993, DMV-Verlag
  131.  
  132.  
  133.   Copyrights
  134.   ~~~~~~~~~~
  135.   Some of the mentioned names or products above may be copyrighted by
  136.   companies or trademarks of companies.
  137.  
  138.  
  139.